W07-2. Deployment - 실습 가이드

7주차 실습: Deployment 로 방명록 운영하기

실습 목표 (45분)

  • Deployment 로 방명록 Pod 3개를 띄우고, Pod 를 지워도 되살아나는 것을 본다.
  • replicas 숫자만 바꿔 늘리고 줄인다.
  • v1(파랑) → v2(초록) 롤링 업데이트를 실시간으로 지켜본다.
  • 없는 버전(v9)을 배포하는 실수를 하고, 롤백으로 되돌린다.

시작 전 확인

  • Docker Desktop 의 Kubernetes 가 running (6주차 실습 0)
  • kubectl config current-context 가 docker-desktop
  • Docker Hub 에 내아이디/guestbook:v1, v2 가 있음 (없으면 6주차 대안처럼 guestbook:v1, guestbook:v2 사용)
  • 작업 폴더로 이동: macOS cd ~/docker-study/k8s / Windows cd "$HOME\docker-study\k8s"
  • 오늘은 터미널을 2개 씁니다(하나는 지켜보기용).

실습 내용 시간
1 Deployment 만들기 7분
2 자가 치유 5분
3 라벨 실험: 관리 대상에서 빼기 4분
4 스케일링 5분
5 롤링 업데이트 v1 → v2 10분
6 실수 배포 (v9) 5분
7 롤백 6분
8 정리 3분

실습 1. Deployment 만들기

1-1. deployment.yaml 작성

VS Code 로 k8s 폴더에 deployment.yaml 을 만듭니다. 내아이디 를 바꾸세요.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: guestbook
  labels:
    app: guestbook
  annotations:
    kubernetes.io/change-cause: "v1 최초 배포"
spec:
  replicas: 3
  selector:
    matchLabels:
      app: guestbook
  template:
    metadata:
      labels:
        app: guestbook
    spec:
      containers:
        - name: web
          image: 내아이디/guestbook:v1
          ports:
            - containerPort: 8000

6주차 pod.yaml 의 metadata 와 spec 이 template: 아래로 들어간 모양입니다. 비교해 보세요.

1-2. 적용하고 완료될 때까지 기다리기

kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook

출력 예시:

deployment.apps/guestbook created
Waiting for deployment "guestbook" rollout to finish: 0 of 3 updated replicas are available...
Waiting for deployment "guestbook" rollout to finish: 1 of 3 updated replicas are available...
Waiting for deployment "guestbook" rollout to finish: 2 of 3 updated replicas are available...
deployment "guestbook" successfully rolled out

1-3. 세 단계 관계 확인

kubectl get deployments
kubectl get replicasets
kubectl get pods -o wide

출력 예시:

NAME        READY   UP-TO-DATE   AVAILABLE   AGE
guestbook   3/3     3            3           7s

NAME                   DESIRED   CURRENT   READY   AGE
guestbook-6694d9fcc5   3         3         3       7s

NAME                         READY   STATUS    RESTARTS   AGE   IP           NODE              NOMINATED NODE   READINESS GATES
guestbook-6694d9fcc5-75h8t   1/1     Running   0          7s    10.244.2.7   desktop-worker    <none>           <none>
guestbook-6694d9fcc5-d4rdk   1/1     Running   0          7s    10.244.2.6   desktop-worker    <none>           <none>
guestbook-6694d9fcc5-mnt7q   1/1     Running   0          7s    10.244.1.2   desktop-worker2   <none>           <none>
확인할 점

  • Deployment 1개 → ReplicaSet 1개(guestbook-6694d9fcc5) → Pod 3개
  • Pod 이름 = Deployment 이름 + ReplicaSet 번호 + Pod 번호
  • NODE 열: Pod 가 desktop-worker, desktop-worker2 에 나뉘어 배치됐습니다. scheduler 가 Worker Node 들에 골고루 나눈 것입니다. (Control Plane 노드에는 앱 Pod 를 두지 않습니다.)
  • 노드를 2개로 만들었다면 Worker 가 1개라서 모두 같은 노드에 놓입니다.

1-4. 브라우저로 확인

kubectl port-forward deployment/guestbook 8080:8000

http://localhost:8080 → 파란 방명록 v1. HOSTNAME 에 Pod 이름이 보입니다.

새로고침해도 HOSTNAME 이 안 바뀌어요

port-forward 는 Pod 3개 중 하나에만 연결하는 테스트용 통로입니다. 3개로 나눠 보내는 것은 8주차 Service 가 합니다.

확인했으면 Ctrl + C 로 끊습니다.


실습 2. 자가 치유

터미널 2를 열고, 같은 폴더에서 Pod 를 계속 지켜봅니다.

kubectl get pods -w

터미널 1에서 Pod 하나를 지웁니다. 이름은 kubectl get pods 로 보고 하나를 골라 넣으세요.

kubectl delete pod guestbook-6694d9fcc5-8f9bh

터미널 2 출력 예시: 지운 Pod 가 Terminating 되는 동시에 새 Pod 가 생깁니다.

guestbook-6694d9fcc5-8f9bh   1/1     Terminating         0          2m
guestbook-6694d9fcc5-2lbmz   0/1     Pending             0          0s
guestbook-6694d9fcc5-2lbmz   0/1     ContainerCreating   0          0s
guestbook-6694d9fcc5-2lbmz   1/1     Running             0          1s

이번에는 3개를 한꺼번에 지워 봅니다. -l 은 라벨로 고르는 옵션입니다.

kubectl delete pods -l app=guestbook
kubectl get pods

출력 예시: 몇 초 뒤 새 이름의 Pod 3개가 Running 입니다.

NAME                        READY   STATUS    RESTARTS   AGE
guestbook-6694d9fcc5-7fqvb  1/1     Running   0          6s
guestbook-6694d9fcc5-8kqk4  1/1     Running   0          6s
guestbook-6694d9fcc5-lftb5  1/1     Running   0          6s
6주차와 비교해 보세요

6주차에는 Pod 를 지우면 그대로 사라졌습니다. 지금은 ReplicaSet 이 "3개 유지" 를 책임지고 즉시 다시 만듭니다.


실습 3. 라벨 실험: 관리 대상에서 빼기

Pod 하나의 라벨을 app=debug 로 바꿉니다. 이름은 내 Pod 중 하나로 바꿔 넣으세요.

kubectl label pod guestbook-6694d9fcc5-7fqvb app=debug --overwrite
kubectl get pods -L app

출력 예시: -L app 은 app 라벨 값을 열로 보여 줍니다.

NAME                         READY   STATUS    RESTARTS   AGE   APP
guestbook-6694d9fcc5-7fqvb   1/1     Running   0          50s   debug
guestbook-6694d9fcc5-8kqk4   1/1     Running   0          49s   guestbook
guestbook-6694d9fcc5-kbpmc   1/1     Running   0          5s    guestbook
guestbook-6694d9fcc5-lftb5   1/1     Running   0          51s   guestbook
Pod 가 4개가 됐습니다. 왜일까요?

ReplicaSet 은 app=guestbook 라벨로 Pod 를 셉니다. 라벨을 바꾼 Pod 는 "내 것이 아니다" 가 되어 2개로 세고, 새로 1개를 만들었습니다.
라벨을 바꾼 Pod 는 지워지지 않고 관리 밖에서 그대로 돕니다. 문제가 생긴 Pod 를 서비스에서 떼어 내 조사용으로 남길 때 쓰는 요령입니다.

관리 밖으로 빠진 Pod 는 직접 지웁니다.

kubectl delete pod guestbook-6694d9fcc5-7fqvb

실습 4. 스케일링

4-1. 선언형: 파일을 고쳐서

deployment.yaml 의 replicas: 3 을 replicas: 5 로 바꾸고 저장합니다.

kubectl apply -f deployment.yaml
kubectl get pods

→ Pod 가 5개가 됩니다.

4-2. 명령형: 급할 때

kubectl scale deployment guestbook --replicas=2
kubectl get pods

→ 2개로 줄어듭니다. 줄일 때는 남는 Pod 를 골라 정상 종료(Terminating) 시킵니다.

4-3. 파일 기준으로 되돌리기

deployment.yaml 을 다시 replicas: 3 으로 고치고 저장합니다.

kubectl apply -f deployment.yaml
kubectl get deployment guestbook

출력 예시:

NAME        READY   UP-TO-DATE   AVAILABLE   AGE
guestbook   3/3     3            3           5m
명령형으로 바꾼 것은 파일에 남지 않습니다

kubectl scale 로 2개로 줄여도 파일에는 그대로 5가 적혀 있었습니다. 누군가 파일로 apply 하면 파일 값으로 돌아갑니다. 그래서 평소에는 파일을 고치는 방식을 씁니다.


실습 5. 롤링 업데이트 v1 → v2

5-1. 지켜볼 준비

터미널 2에서 지켜보던 명령이 꺼졌다면 다시 켭니다.

kubectl get pods -w

5-2. 파일 고치기

deployment.yaml 에서 두 곳을 바꿉니다.

  annotations:
    kubernetes.io/change-cause: "v2 배포 (초록)"
          image: 내아이디/guestbook:v2

5-3. 적용

터미널 1:

kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook

터미널 2 출력 예시: 새 ReplicaSet(5f994cddb4)의 Pod 가 하나 Running 이 될 때마다 옛 Pod(6694d9fcc5)가 하나씩 Terminating 됩니다.

guestbook-5f994cddb4-8q9lw   0/1     Pending             0          0s
guestbook-5f994cddb4-8q9lw   0/1     ContainerCreating   0          0s
guestbook-5f994cddb4-8q9lw   1/1     Running             0          1s
guestbook-6694d9fcc5-zlp58   1/1     Terminating         0          29s
guestbook-5f994cddb4-jmmpj   0/1     Pending             0          0s
guestbook-5f994cddb4-jmmpj   0/1     ContainerCreating   0          0s
guestbook-5f994cddb4-jmmpj   1/1     Running             0          0s
guestbook-6694d9fcc5-pwp8r   1/1     Terminating         0          29s
guestbook-5f994cddb4-w4sq9   0/1     Pending             0          0s
guestbook-5f994cddb4-w4sq9   0/1     ContainerCreating   0          0s
guestbook-5f994cddb4-w4sq9   1/1     Running             0          1s
guestbook-6694d9fcc5-2lbmz   1/1     Terminating         0          29s
강의 노트 4장 그대로입니다

1개 추가 → 준비되면 1개 종료 를 3번 반복했습니다. 그동안 Running 인 Pod 가 항상 3개 이상이었습니다. 이것이 무중단 배포입니다.

5-4. ReplicaSet 과 이력

kubectl get replicasets
kubectl rollout history deployment/guestbook

출력 예시:

NAME                   DESIRED   CURRENT   READY   AGE
guestbook-5f994cddb4   3         3         3       30s
guestbook-6694d9fcc5   0         0         0       8m

deployment.apps/guestbook
REVISION  CHANGE-CAUSE
1         v1 최초 배포
2         v2 배포 (초록)

옛 ReplicaSet(6694d9fcc5)은 0개로 남아 있습니다. 롤백할 때 다시 씁니다.

5-5. 브라우저 확인

kubectl port-forward deployment/guestbook 8080:8000

http://localhost:8080 → 초록색 방명록 v2 🎉 확인 후 Ctrl + C.


실습 6. 실수 배포 (v9)

존재하지 않는 v9 를 배포하는 실수를 일부러 해 봅니다.

deployment.yaml 에서:

    kubernetes.io/change-cause: "v9 배포 (실수)"
          image: 내아이디/guestbook:v9
kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook --timeout=30s

출력 예시: 끝나지 않고 30초 뒤 포기합니다.

Waiting for deployment "guestbook" rollout to finish: 1 out of 3 new replicas have been updated...
error: timed out waiting for the condition
kubectl get pods
kubectl get deployment guestbook

출력 예시:

NAME                         READY   STATUS             RESTARTS   AGE
guestbook-5c96fffb47-p5pgw   0/1     ImagePullBackOff   0          30s
guestbook-5f994cddb4-c566p   1/1     Running            0          2m
guestbook-5f994cddb4-f89d9   1/1     Running            0          2m
guestbook-5f994cddb4-q74qh   1/1     Running            0          2m

NAME        READY   UP-TO-DATE   AVAILABLE   AGE
guestbook   3/3     1            3           10m
서비스는 멀쩡합니다

  • 새 버전 Pod 1개만 ImagePullBackOff 로 멈춰 있고, v2 Pod 3개는 그대로 Running 입니다.
  • READY 3/3, AVAILABLE 3 → 사용자는 아무 문제 없이 v2 를 쓰고 있습니다.
  • 새 Pod 가 준비되지 않으면 옛 Pod 를 내리지 않는 롤링 업데이트의 안전장치 덕분입니다.
  • STATUS 는 ErrImagePull 과 ImagePullBackOff 가 번갈아 보일 수 있습니다.


실습 7. 롤백

7-1. 바로 되돌리기: rollout undo

kubectl rollout undo deployment/guestbook

출력 예시:

Warning: resource deployments/guestbook was previously managed with 'kubectl apply'. Rolling back will not update the kubectl.kubernetes.io/last-applied-configuration annotation, which may cause unexpected behavior on future 'kubectl apply' operations. Consider using 'kubectl apply' with your previous configuration file instead.
deployment.apps/guestbook rolled back
kubectl rollout status deployment/guestbook
kubectl get pods
kubectl rollout history deployment/guestbook

출력 예시:

deployment "guestbook" successfully rolled out

NAME                         READY   STATUS    RESTARTS   AGE
guestbook-5f994cddb4-c566p   1/1     Running   0          3m
guestbook-5f994cddb4-f89d9   1/1     Running   0          3m
guestbook-5f994cddb4-q74qh   1/1     Running   0          3m

deployment.apps/guestbook
REVISION  CHANGE-CAUSE
1         v1 최초 배포
3         v9 배포 (실수)
4         v2 배포 (초록)

7-2. 파일도 되돌리기 (중요!)

경고 메시지처럼, 내 deployment.yaml 에는 아직 v9 가 적혀 있습니다. 파일을 v2 로 되돌립니다.

    kubernetes.io/change-cause: "v2 배포 (초록)"
          image: 내아이디/guestbook:v2
kubectl apply -f deployment.yaml
kubectl get pods
kubectl rollout history deployment/guestbook

출력 예시:

deployment.apps/guestbook configured
NAME                         READY   STATUS    RESTARTS   AGE
guestbook-5f994cddb4-7bl5l   1/1     Running   0          39s
guestbook-5f994cddb4-hf9t7   1/1     Running   0          41s
guestbook-5f994cddb4-j55xh   1/1     Running   0          40s

deployment.apps/guestbook
REVISION  CHANGE-CAUSE
1         v1 최초 배포
3         v9 배포 (실수)
4         v2 배포 (초록)

configured 가 나오지만 Pod 이름과 AGE 가 그대로입니다. 클러스터는 이미 v2 로 돌아가 있으므로 Pod 를 바꾸지 않고, "마지막으로 apply 한 파일 내용" 기록만 파일과 맞춘 것입니다. 이제 파일과 클러스터가 같은 상태(v2)입니다.

실무 원칙: 파일이 진실이다

클러스터 상태와 파일 내용이 다르면 언젠가 사고가 납니다. 되돌릴 때도 파일을 고쳐서 apply 하는 습관을 들이세요.


실습 8. 정리

8주차에도 이 Deployment 를 그대로 씁니다. 지우지 않아도 됩니다.

노트북이 무거우면 지워도 됩니다(8주차 시작할 때 kubectl apply -f deployment.yaml 로 다시 만듭니다).

kubectl delete -f deployment.yaml

터미널 2 의 kubectl get pods -w 는 Ctrl + C 로 끝냅니다.


자주 나는 문제와 해결

증상 원인 해결
`selector` does not match template `labels` selector.matchLabels 와 template.metadata.labels 가 다름 두 곳의 app: guestbook 을 똑같이
apply 했는데 아무 변화 없음 (unchanged) 파일을 저장하지 않음 VS Code 탭 이름 옆의 ● 표시(저장 안 됨) 확인 후 저장
rollout status 가 끝나지 않음 새 Pod 가 준비되지 않음 (이미지 오타 등) kubectl get pods → 문제 Pod describe → 고치거나 rollout undo
rollout history 의 CHANGE-CAUSE 가 <none> change-cause 애너테이션을 안 적음 metadata.annotations 에 적고 apply
port-forward 가 unable to listen on any of the requested ports 8080 을 다른 것이 사용 중 (이전 port-forward 가 안 꺼짐 등) 다른 터미널의 port-forward 를 Ctrl + C, 또는 8081:8000 사용
kubectl delete pod 이름 에서 NotFound 이름 오타, 또는 이미 새 이름으로 바뀜 kubectl get pods 로 현재 이름 확인 (Pod 이름은 다시 만들어질 때마다 바뀜)

오늘 쓴 명령어 정리

명령어 하는 일
kubectl apply -f deployment.yaml Deployment 만들기 / 바꾸기
kubectl rollout status deployment/이름 [--timeout=30s] 배포 완료까지 기다리기
kubectl get deployments / replicasets / pods 세 단계 확인
kubectl get pods -w 실시간으로 지켜보기
kubectl get pods -L app 라벨 값을 열로 보기
kubectl delete pods -l app=guestbook 라벨로 골라 지우기
kubectl label pod 이름 키=값 --overwrite 라벨 바꾸기
kubectl scale deployment 이름 --replicas=N 개수 바꾸기 (명령형)
kubectl port-forward deployment/이름 8080:8000 Deployment 의 Pod 하나로 테스트 연결
kubectl rollout history deployment/이름 배포 이력
kubectl rollout undo deployment/이름 [--to-revision=N] 롤백

복습 과제

확인 퀴즈

  1. Deployment, ReplicaSet, Pod 는 각각 무엇을 책임지나요?
  2. Pod 3개를 한꺼번에 지웠는데 몇 초 뒤 다시 3개가 됐습니다. 누가, 어떤 기준으로 다시 만들었나요?
  3. Pod 하나의 라벨을 app=debug 로 바꿨더니 Pod 가 4개가 됐습니다. 이유는?
  4. 롤링 업데이트 중에 서비스가 끊기지 않는 이유는?
  5. v9 처럼 없는 이미지를 배포했을 때 사용자에게 영향이 없었던 이유는?
  6. kubectl rollout undo 후에 꼭 해야 할 일은?

도전 과제 (선택)

  1. deployment.yaml 의 spec: 아래(replicas 와 같은 칸)에 아래를 추가하고, v1 ↔ v2 를 바꿔 가며 kubectl get pods -w 로 교체 순서가 어떻게 달라지는지 보세요.
      strategy:
        type: RollingUpdate
        rollingUpdate:
          maxSurge: 3
          maxUnavailable: 0
    
    (maxSurge: 3 이면 새 버전 3개를 한꺼번에 띄운 뒤 옛 버전을 내립니다.)
  2. kubectl rollout undo deployment/guestbook --to-revision=1 로 맨 처음 v1 으로 돌아가 보세요. 그다음 파일도 v1 으로 맞춰 apply 합니다.
  3. kubectl rollout restart deployment/guestbook 은 무엇을 할까요? 실행하고 Pod 이름과 AGE 를 보세요. (이미지는 그대로, Pod 만 모두 새로 교체합니다. 설정을 다시 읽게 할 때 씁니다.)
다음 주 예고: 8주차 Service 와 Gateway API

지금은 port-forward 로 Pod 하나에만 접속했습니다. 다음 주에는 Pod 3개 앞에 Service 를 두어 하나의 주소로 나눠 받고, Gateway API 로 guestbook.localhost 같은 도메인 주소로 외부에 공개합니다.


네비게이션

이전 목록 다음
◀ 7주차 강의 노트 목록으로 8주차 강의 노트 ▶